RSW920010220US1 
D 0 MeJgar 

Generating Class Library to Represent Messages Described m a Structured 
1/24 



FIG. 1 



100 



Source 
template 



120 




XML 
Schema 







110 



Generator 



150 




RSW92001Q220US1 
D. 0 Meigar 

Generating CJass Library to Represent Messages Descrfoed in a Structured Language Schema 
2/24 



FIG. 2 

200 

S^210 

<element name = "discoveryURL"> ^ 
<type source = "string" content = "textOnly"> 

ottribute name = "useType" minOccurs = "1" type = "string"/> 
</type> 
</element> 



300 



FIG. 3 



# 

# Set directory to output generated files to 
# 

outputDirectory = . ^^310 

classJavadoc.O = ' * <p><b>General information:</b><p> 

M^330 

FindQualifier.classVariableDeclare.O = 1 /** Valid values */ 
FindQualifier.classVariableDeclare.1= ' public static final String exactNameMatch 
"exactNameMatch"; ^^340 

DispositionReport.dontGenerate = true ^ 

DiscoveryURLpackageName = com.ibm.util 
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400 



FIG. 4A 



package com.ibm.util; * r ^405 

/** <p><b>General information:</b><p> */ *^ 410 
public class DiscoveryURL { 

String text = null; 
String useType = null; 

public DiscoveryURL() { 
} 



/** 

* Construct the object with required fields. 

* 

* @param value String value A ' v ' 

* @param useType String xv-445 

7 

public DiscoveryURL(String value, ^ 

String useType) { I ^ 450 

setText(value); ' 
this.useType = useType; 

} 



J 



* Construct the object from a DOM tree. Used by 

* UDDIProxy to construct an object from a received UDDI 

* message. 

* @param base Element with name appropriate for this class. 

* 

* ©exception UDDIException Thrown if DOM tree contains a SOAP fault 

* or a disposition report indicating a UDDI error. 
*' XV. 460 

public DiscoveryURL(Element base) { ^ 
// Check if its a fault Throw exception if it is 
super(base); V 
text = getText(base); 

useType = base.getAttribute("useType"); j 

> 



/V. 465 
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FIG. 4B 

public void setText(String s) { 
text = s; 

} 

public String getText() { 
return text; 

} ^475 

public void setUseType(String s) { 
useType = s; 

} 

public String getUseType() { 
return useType; 

} 

* Save an object to the DOM tree. Used to serialize an object 

* to a DOM tree, usually to send a UDDI message. 

* 

* <BR>Used by UDDIProxy. 

* 

* @param parent Object will serialize as a child element under the 

* passed in parent element. 

*/ 

public void saveToXML(Element parent) { 
base = parent.getOwnerDocument().createElement(UDDI_TAG); 

// Save attributes 
if (text!=null) { 

base.appendChild(parent.getOwnerDocument().createTextNode(text)); 

} 

if (useType!=null) { 
base.setAttribute("useType", useType); 

} 

parentappendChild(base); 

} 

} 
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FIG. 5 

500 



S^505 

II Create and interact with classes to create message y^. 510 

DiscoveryURL durl = new DiscoveryURL("url_value", "usetype_value"); 
durl.setXXX // set any additional attributes. This particular class has none. 

,^520 v/-5f5 
// Create element to serialize object to 

DocumentBuilderFactory factory = DocumentBuilderFactory.newlnstance(); 
DocumentBuilder docBuilder = factory.newDocumentBuilder(); 
Element base = docBuilder.newDocument().createElement("tmp"); 

y\^525 

II Invoke generated serialization method 
durl.saveToXML(base); 

530 

II Convert DOM to format used by messaging interface 
String message = DOMWriter.nodeToString(el) 

S\^535 

II Invoke desired mechanism to send/receive an XML message 

transport.send(message); 

String response = transport. receive(); 

S^540 

II Convert response back to generated object form 

Element responseEl = parse(response); 

DiscoveryURL response = new DiscoveryURL(responseEI); 

^545 

II Can interact with object form of the message 

System.out.println(response.getText()); 

System.out.println(response.getUseType()); 
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FIG. 6 

600 



<element name = "businessEntity"> 

<type content = "elementOnly">^^ eQ5 
<annotation> Nk/ ^ q^q 
<applnfo> 

Primary Data type: Describes an instance of 
a business or business unit. 
</applnfo> 
</annotation> 
<group order = "seq"> 

<element ref = "discoveryURLs" minOccurs = "0" maxOccurs = "17> 
<element ref = "name"/> y^, 615 

<element ref = "description" minOccurs = "0" maxOccurs = "*"/> 
<element ref = "contacts" minOccurs = "0" maxOccurs = "17> 
<element ref = "businessServices" minOccurs = "0" maxOccurs = "17> 
<element ref = "identifierBag" minOccurs = "0" maxOccurs = "17> 
<element ref = "categoryBag" minOccurs = "0" maxOccurs = "1"/> 
</group> 

<attribute name = "businessKey" minOccurs = "1" type = "string"/> 
ottribute name = "operator" type = "string"/> 
ottribute name = "authorizedName" type = "string7> 
</type> 
</element> 
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700 FIG. 7 A 

/* 

* The source code contained herein is licensed under the IBM Public License 

* Version 1 .0, which has been approved by the Open Source Initiative. 

* Copyright (C) 2001 , International Business Machines Corporation 

* All Rig hts Reserved . 702 



*/ 



package %packageName%; ^ 704 

import java.uti I. Vector; ^j^jqq 
import org.w3c.dom.*; 
import com.ibm.uddi.*; 
import com.ibm.uddi.datatype.*; 
import com.ibm.uddi.datatype.binding.*; 
import com.ibm.uddi.datatype.business.*; 
import com.ibm.uddi.datatype.service.*; 
import com.ibm.uddi.datatype.tmodel.*; 
import com.ibm.uddi.request.*; 
import com.ibm.uddi. response.*; 
inport com.ibm.ussi.util.*; 



/** 

1 „ frs^ 70S 

* <p><b>General information:</b><p> 

* 



* This class represents an element within the UDDI version 1 .0 schema. 

* This class contains the following types of methods:<ul> 

* 

* <li>A constructor that passes the required fields. 

* <li>A Constructor that will instantiate the object from an XML DOM element 

that is the appropriate element for this object. 

* <li>Get/set methods for each attribute that this element can contain. 

* <li>For sets of attributes, a get/setVector method is provided. 

* <li>A SaveToXML method that serializes this class within a passed in 

* element. 

* </ul> 
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FIG. 7B 

* Typically, this class is used to construct parameters for, or interpret 

* responses from, methods in the UDDIProxy class. 

* 

* <p><t»Element description :</t»<p> 

* 

%foreach%annotation% *^ 720 

* %annotation% _ _ 

%end% ^ 722 

* 

* <p> 

©author David Melgar (dmelgar@us.ibm.com) 



* 
* 

*/ 



public class %ElementName% extends UDDI Element { 
public static final String UDDI_TAG = "%elementName%"; 

protected Element base = null; 



%ifText% 

String text = null; 
%end% 

%forEach%Attribute% 

String %attribute% = null; 
%end%A 

%forEach%Child% 

%Child% %child% = null; 
%end% 

%forEach%ChildCollection% 
// Bector of %Child% objects 
Vector %child% = new Vector(); 

%end% 
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FIG. 7C 



I** 

* Default constructor. 

* Avoid using the default constructor for validation. It does not validate 

* required fields. Instead, use the required fields constructor to perform 

* validation. 

7 

public %ElementName%() { 
} 



r * 746 

* Construct the object with required fields. 

* 

%ifText% 748 

* @param value String value 
%end% 

%forEach%required%attribute% *^ 7S0 

* @param %attribute% String 
%end% 

%forEach%Child% 
%end% 

%forEach%ChildCollection% 
%end% 

*' AA— 752 

public %ElementName%(%forEach%required%,%end%) { 

%ifText% 754 

setText( value); 

%end% 

%forEach%required%Attribute% 756 

this.%attribute% = %attribute%; 
%end% 

%forEach%required%TextOnlyChild% 

this.%child% = new %Child%( %child% ); 

} 
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FIG. 7D 



Construct the object from a DOM tree. Used by 
UDDIProxy to construct an object from a received UDDI 
message. 



* @param base Element with name appropriate for this class. 



s 

P5 5 



a 



©exception UDDIException 

Thrown if DOM tree contains a SOAP fault or 
disposition report indicating a UDDI error. 



*/ 

public %ElementName%(Element base) throws UDDIException { 
// Check if it is a fault. Throws an exception if it is. 
super(base); 
%ifText% 

text = getText(base); 
%end% 

%forEach%Attribute% 

%attribute% = base.getAttribute("%attribute%"); 
%end% 

NodeList nl = null; 
%forEach%Child% 

nl = getChildElementsByTagName(base, %Child%.UDDI_TAG); 

if(nl.getLength()>0){ 
%Child% = new %Child%((Element)nl.item(0)); 

} 

%end% 

%forEach%ChildCollection% 

nl = getChildElementsByTagName(base, %Child%.UDDI_TAG); 
for (int i=0; i < nl.getl_ength(); i++) { 
%child%.addElement(new%Child%((Element)nl.item(i))); 

} 

} 
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FIG. 7E 



%itText% ^ 780 

public void setText(String s) { 
text = s; 

} 

public String getText() { ^ 782 
return text; 

} 

%end% 

%forEach%Attribute% *^ 784 

public void set%attribute%(String s) { 
%attribute% = s; 

} 

786 

public String get%attribute%() { 
return %attribute%; 

} 

%end% 
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FIG. 7F 



* Save an object to the DOM tree. Used to serialize an object 

* to a DOM tree, usually to send a UDDI message. 

* <BR>Used by UDDIProxy. 

* 

* @param parent Object will serialize as a child element under the 

* passed in parent element. 

public void saveToXML(Element parent) { 
base = parent.getOwnerDocument().createElement(UDDI_TAG); 
// Save attributes. 
%ifText% 

if (text!=null){ X^790 
base.appendChild(parent.getOwnerDocument().createTextNode(text)); 

} 

%end% 

%forEach%Attribute% 

if (%attribute%!=null) { 792 
base.setAttribute("%attribute%", %attribute%); 

} 

%end% x'V- 794 

parent.appendChild(base); 

} 
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FIG. 8A 

800 



I* 

* The source code contained herein is licensed under the IBM Public License 

* Version 1.0, which has been approved by the Open Source Initiative. 

* Copyright (C) 2001, International Business Machines Corporation 

* All Rights Reserved. 

* 

*/ 

package com.ibm.uddi.clatatype.business; 
import java.util.Vector; 
import org.w3c.dom *; 
import com.ibm.uddi.*; 
import com.ibm.uddi.datatype.*; 
import com.ibm.uddi.datatype.binding.*; 
import com.ibm.uddi.datatype.business*; 
import com.ibm.uddi.datatype.service.*; 
import com.ibm.uddi.datatype.tmodel *; 
import com.ibm.uddi.request.*; 
import com.ibm.uddi.response .*; 
import com.ibm.uddi.util *; 



* <p><b>GeneraI information:</b><p> 

* 

* This class represents an element within the UDDI version 1.0 schema. 

* This class contains the following types of methods;<ul> 

* <li>A constructor that passes the required fields. 

* <li>A Constructor that will instantiate the object from an XML DOM element 

* that is the appropriate element for this object. 

* <li>Get/set methods for each attribute that this element can contain. 

* <li>For sets of attributes, a get/setVector method is provided. 

* <li>A SaveToXML method that serializes this class within a passed in 

* element. 

* </ul> 
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FIG. 8B 



* Typically this class is used to construct parameters for, or interpret 

* responses from methods in the UDDIProxy class. 

* 

* <p><b>Element description:</b><p> 

* Primary Data type: Describes an instance of a business or business unit. 

*<p> 

* 

* ©author David Melgar 

*/ 

public class BusinessEntity extends UDDIEIement { 
public static final String UDDIJTAG = "businessEntity"; 

protected Element base = null; 



String businessKey = null; 

String operator = null; 

String authorized Name = null; 

DiscoveryURLs discoveryURLs = null; 

Name name = null; 

Contacts contacts = null; 

BusinessServices businessServices = null; 

IdentifierBag identifierBag = null; 

Category Bag category Bag = null; 

// Vector of Description objects 

Vector description = new VectorQ; 320 
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FIG. 8C 



I** 

* Default constructor. 

* Avoid using the default constructor for validation. It does not validate 

* required fields. Instead, use the required fields constructor to perform 

* validation. 

*/ 

public BusinessEntity() { 
} 

* Construct the object with required fields. 

* @param businessKey String 
*@paramname String 

7 

public BusinessEntity(String businessKey, 
String name) { 
this. businessKey = businessKey; 
this.name = new Name( name ); 

} 

* Construct the object from a DOM tree. Used by 

* UDDIProxy to construct object from a received UDDI 

* message. 

* 

* @param base Element with the name appropriate for this class. 

* 

* ©exception UDDIException 

Thrown if DOM tree contains a SOAP fault or 

* disposition report indicating a UDDI error. 

7 
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FIG. 8D 



public BusinessEntity(Element base) throws UDDIException { 
// Check if its a fault. Throw exception if it is. V/-- 825 

super(base); 

businessKey = base.getAttributefbusinessKey"); 
operator = base.getAttributef'operator"); 
authorizedName = base.getAttributefauthorizedName"); 
NodeList nl = null; 

nl = getChildElementsByTagName(base, DiscoveryURLs.UDDI_TAG); 
if(nl.getLength()>0){ 
discoveryURLs = new DiscoveryURLs((Element)nl.item(0)); 

} 

nl = getChildElementsByTagName(base, Name.UDDI TAG); 
if(nl.getLength()>0){ 
name = new Name((Element)nl.item(0)); 

} 

nl = getChildElementsByTagName(base, Contacts. UDDI_TAG); 
if (nl.getLength() > 0) { 
contacts = new Contacts((Element)nl.item(0)); 

} 

nl = getChildElementsByTagName(base, BusinessServices.UDDI_TAG); 
if (nl.getLength() > 0) { 
businessServices = new BusinessServices((Element)nl.item(0)); 

} 

nl = getChildElementsByTagName(base, ldentifierBag.UDDI_TAG); 
if (nl.getLength() > 0) { 
identifierBag = new ldentifierBag((Element)nl.item(0)); 

} 

nl = getChildElementsByTagName(base, CategoryBag.UDDI_TAG); 
if(nl.getLength()>0){ 

categoryBag = newCategoryBag((Element)nl.item(0)); 
} ^ 

nl = getChildElementsByTagName(base, Description. UDDI_TAG); 
for (int i=0; i < nl.getLength(); i++) { 
description.addElement(new Description((Element)nl.item(i))); 

} 



} 
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FIG. 8E 



public void setBusinessKey(String s) { 
businessKey = s; 

} 

public void setOperator(String s) { 
operator = s; 

} 

public void setAuthorizedName(String s) { 
authorized Name = s; 

} 

public void setDiscoveryURLs(DiscoveryURLs s) { 
discoveryURLs = s; 

} 

public void setName(Name s) { 
name = s; 

} 

public void setName(String s) { 
name = new Name(); 
name.setText(s); 

} 

public void setContacts(Contacts s) { 
contacts = s; 

} 

public void setBusinessServices(BusinessServices s) { 
businessServices = s; 

} 

public void setldentifierBag(ldentifierBag s) { 
identifierBag = s; 

} 
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FIG. 8F 



public void setCategoryBag(CategoryBag s) { 
categoryBag = s; 

} 

j** 

* Set description vector 

* 

* @param s Vector of <l>Description</l> objects. 

*/ 

public void setDescriptionvector(Vector s) { 
description = s; 

} 

I** 

* Set default (english) description string 

* @param s String 

*/ 

public void setDefaultDescriptionString(String s) { 835 
if (description. size() > 0) { 
description.setElementAt(new Description(s), 0); 

} else { 

description.addElement(new Description(s)); 

} 

} 

public String getBusinessKey() { 
return businessKey; 

} 

public String getOperator() { 
return operator; 

} 
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FIG. 8G 



public String getAuthorizedName() { 
return authorizedName; 

} 



public DiscoveryURLs getDiscoveryURLs() { 
return discovery URLs; 

} 



public Name getName() { 
return name; 

} 

public String getNameStringO { 
return name.getText(); 

} 

public Contacts getContactsQ { 
return contacts; 

} 



public BusinessServices getBusinessServicesQ { 
return businessServices; 

} 



public IdentifierBag getldentifierBag() { 
return identifierBag; 

} 



public CategoryBag getCategoryBagO { 
return categoryBag; 

} 
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FIG. 8H 



j-k-k 

* Get description 

* 

* ©return s Vector of <l>Description</l> objects. 

7 

public Vector getDescriptionVectorQ { 
return description; 

} 

* Get default description string 

* ©return s String 
*/ 

public String getDefaultDescriptionString() { 
if ((description). size() > 0) { 

Description t = (Description)description.elementAt(O); 

return t.getText(); 
} else { 

return null; 

} 

} 



/** K^ 840 

* Save an object to the DOM tree. Used to serialize an object 

* to a DOM tree, usually to send a UDDI message. 

* 

* <BR>Used by UDDIProxy. 

* 

* @param parent Object will serialize as a child element under the 

* passed in parent element. 

7 
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public void saveToXML(Element parent) { 
base = parent.getOwnerDocument().createElement(UDDI_TAG); 
// Save attributes 
if (businessKey!=null) { 
base.setAttribute("businessKey", businessKey); 

} 

if (operator!=null) { 
base.setAttributefoperator", operator); 

} 

if (authorizedName!=null) { 
base.setAttribute("authorizedName", authorized Name); J 

if (discoveryURLs!=null) { *^ 850 
d iscovery U RLs . sa veToXM L( base) ; 

} 

if (name!=null) { 
name.saveToXML(base); 

* ^ 855 

for (int i=0; i < description.size(); i++) { 

((Description)(description.elementAt(i))).saveToXML(base); 

} 

if (contacts!=null) { 
contacts.saveToXML(base); 

} 

if (businessServices!=null) { 
businessServices.saveToXML(base); 

} 

if (identifierBag!=null) { 
identifierBag.saveToXML(base); 

} 

if (category Bag !=null) { 
category Bag .saveToXML(base) ; 

} 

parent.appendChild(base); 
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FIG. 9A 
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FIG. 9B 
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FIG. 10 
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